home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / comm / net / plip3818.lha / plip / plip.doc < prev   
Text File  |  1995-07-03  |  9KB  |  374 lines
  1.  
  2.  
  3.      Page 1                        PLIP                         Page 1
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                    PLIP
  22.                              Parallel Line IP
  23.                    Copyright (c) 1995 by Martin Laubach
  24.           Copyright (c) 1994 by Oliver Wagner and Michael Balzer
  25.                             All rights reserved
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                   This manual is intended to be read from
  44.                     front to back for more convenience.
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.      Page 2                        PLIP                         Page 2
  66.  
  67.  
  68.  
  69.   1. Introduction      
  70.  
  71.        PLIP is a network device driver conforming to the SANA2
  72.      standard.  It allows linking of two Amigas using their built-in
  73.      parallel ports.  PLIP is intended as a low-cost networking
  74.      solution since the capabilities of the parallel hardware are
  75.      somewhat limited.  However, it gives much better results than
  76.      SLIP and leaves the serial port free.  
  77.  
  78.        Please read the entire manual before using PLIP.  
  79.  
  80.   1.1. Historic overview   
  81.  
  82.        Oliver Wagner and Michael Balzer stopped development of the
  83.      PLIP driver at version 38.11. However, this release had several
  84.      drawbacks and lacked some needed capabilities, so I decided to
  85.      take over where they left off.  
  86.  
  87.   2. Installation      
  88.  
  89.   2.1. Requirements    
  90.  
  91.        You will need at least kickstart 2.04 (37.175) to use PLIP.
  92.      Also some SANA2 compliant networking protocol stack (like Envoy,
  93.      AS225R2 or AmiTCP) is necessary to actually use PLIP.  
  94.  
  95.   2.2. Cabling    
  96.  
  97.        You need male (on an A1000 female) DB25 connectors and some
  98.      (up to 4 meters) parallel cable.  
  99.  
  100.        Connect 
  101.                D0-D7       to      D0-D7
  102.                BUSY        to      BUSY
  103.                POUT        to      POUT
  104.                ACK         to      STROBE
  105.                STROBE      to      ACK
  106.                GND         to      GND
  107.  
  108.        You can look up the pin assignment in your Amiga User Manual,
  109.      Appendix A.  Please note that this cable differs from ParNet!
  110.      Double check before using! 
  111.  
  112.  
  113.        There is a potential problem with the RI (ring indicator) line
  114.      on the serial port. If you have problems running PLIP, first try
  115.      to remove any device connected to the serial port. If that
  116.      helps, you might try cutting the RI line in the serial
  117.      connector.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.      Installation                                           Cabling
  125.  
  126.  
  127.      Page 3                        PLIP                         Page 3
  128.  
  129.  
  130.   2.3. Installing    
  131.  
  132.        Copy plip.device to devs:networks.  See the documentation of
  133.      your networking package for further installation steps.  
  134.  
  135.        Note that if you are going to use both Envoy and TCP/IP over
  136.      PLIP at the same time, you might consider using different packet
  137.      types for Envoy than the default 2048.  While the default value
  138.      works fine, it induces quite some overhead and you will find
  139.      that different packet types for Envoy speed up things
  140.      considerably.  
  141.  
  142.        Since PLIP only allows two hosts to be linked together,
  143.      addressing is limited to 1 Bit.  One host uses plip.device unit
  144.      0, the other one plip.device unit 1.  The device will not work
  145.      correctly if both machines use the same unit number.  
  146.  
  147.  
  148.   3. Miscellanea      
  149.  
  150.   3.1. Support    
  151.  
  152.        If you have any suggestions, bug reports etc., feel free to
  153.      contact the author at 
  154.  
  155.             Martin Laubach
  156.             Fido:    2:310/3.14
  157.             Email: mjl@auto.tuwien.ac.at
  158.  
  159.   3.2. No Warranty   
  160.  
  161.        THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED
  162.      BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
  163.      COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS
  164.      IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
  165.      INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  166.      MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
  167.      RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH
  168.      YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
  169.      ALL NECESSARY SERVICING, REPAIR OR CORRECTION.  
  170.  
  171.        IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  172.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  173.      REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU
  174.      FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
  175.      CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  176.      THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
  177.      BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  178.      PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  179.      PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED
  180.      OF THE POSSIBILITY OF SUCH DAMAGES.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.      Miscellanea                                         No Warranty
  187.  
  188.  
  189.      Page 4                        PLIP                         Page 4
  190.  
  191.  
  192.  
  193.   3.3. Disclaimer    
  194.  
  195.        No warranty, either express or implied, is made with respect
  196.      to the fitness or merchantability of PLIP.  
  197.  
  198.        Martin Laubach (referred to as "the author"), reserve the
  199.      right to not develop any future versions of PLIP.  
  200.  
  201.        The author will try to make a good faith attempt at correcting
  202.      any problems if any are discovered, but are in no way required,
  203.      nor bound to correct them.  
  204.  
  205.        The author neither assumes nor accepts any responsibility for
  206.      the use or misuse of this program. They also will not be held
  207.      liable for damages or any compensation beyond the original
  208.      registration fee due to loss of profit or any other damages
  209.      arising out of the use, or inability to use this program.  
  210.  
  211.        Martin Laubach will not be liable for any damage arising from
  212.      the failure of this program to perform as described, or any
  213.      destruction of other programs or data residing on a system
  214.      attempting to run the program. While we know of no damaging
  215.      errors, the user of this program uses it at his or her own
  216.      risk.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.      Miscellanea                                         Disclaimer
  249.  
  250.  
  251.      Page 5                        PLIP                         Page 5
  252.  
  253.  
  254.  
  255.   4. Acknowledgements      
  256.  
  257.        The following names are either trademarks or the efforts of
  258.      the person and/or company listed: 
  259.  
  260.           Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  261.           PLIP originally by Oliver Wagner and Michael Balzer.
  262.           Envoy 2.0 by Intangible Assest Manufacturing, thanks to
  263.                     Dale Larson and Heinz Wrobel.
  264.  
  265.   5. Changes      
  266.  
  267.        The following lists the major difference to PLIP 38.11 
  268.  
  269.  
  270.           Plip 37.15
  271.  
  272.           - Standard version string
  273.           - Major code cleanup
  274.           - Line arbitration now symmetrical regardless of master/slave
  275.           - Extended checksum calculation to packet envelope
  276.           - Implemented GETSPECIALSTATS
  277.           - READORPHAN returns complete wire packet, corrected
  278.  
  279.           Plip 37.17
  280.  
  281.           - Fixed broken DEVICEQUERY
  282.           - Implemented SANA2IOFRAW on read
  283.           - Reduced static memory consumption
  284.           - Do not fail when CopyBuf routines are missing on open
  285.           - Implemented Packet Filter
  286.           - Fixed broken IOQUICK bit handling
  287.  
  288.           Plip 37.18
  289.  
  290.           - Reworked AbortIO. Correctly locks lists and removes io
  291.             regardless of whether it's in one of my lists. Caveat emptor
  292.           - Eliminated race condition. Initializing lists was done in
  293.             server process but could be used before that
  294.           - Removed antique unused code
  295.           - struct BufRoutines now contains node for linking and list for
  296.             requests. Allows multiple protocol stacks on same packet type.
  297.           - Removed configuration file parsing.
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.      Changes
  311.  
  312.  
  313.      Page 6                        PLIP                         Page 6
  314.  
  315.  
  316.   6. Road Map    
  317.  
  318.  
  319.  
  320.         1. Introduction     ....................................    2
  321.            1.1. Historic overview  .............................    2
  322.         2. Installation     ....................................    2
  323.            2.1. Requirements   .................................    2
  324.            2.2. Cabling   ......................................    2
  325.            2.3. Installing   ...................................    2
  326.         3. Miscellanea     .....................................    3
  327.            3.1. Support   ......................................    3
  328.            3.2. No Warranty  ...................................    3
  329.            3.3. Disclaimer   ...................................    4
  330.         4. Acknowledgements     ................................    5
  331.         5. Changes     .........................................    5
  332.         6. Road Map    .........................................    6
  333.  
  334.  
  335.  
  336.  
  337.  
  338.                  "This is the end. Please pull the plug."
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.      Road Map
  373.  
  374.